home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / usemall.zip / USEMALL.DOC < prev    next >
Text File  |  1988-03-02  |  5KB  |  95 lines
  1.                             USEMALL
  2.                A quick utility to run PCBOARD D)oorware
  3.                     on RBBS 15.1C & greater
  4.                       by Phil Dewitt with
  5.                     some help from Steven Kling  
  6.  
  7.  
  8.     PCBoard D)oorware can be a real pain to setup on an RBBS system.
  9. PCBoard door entry and exit routines are not standardized.  We found
  10. this out when we tried to use several of the more common RBBS-PCB
  11. utilities to make a particular PCBoard Door run under RBBS (Power 
  12. Struggle).  Out of this effort we derived the following utility.
  13. Simply put, when executed this utility will generate a PCBOARD.SYS
  14. and PCBOARD.DAT file which works with all tested PCBOARD D)oors versions
  15. 11 and 12.  All that Usemall needs is to be in the same directory as
  16. DORINFOx.DEF and optionally the same directory as the MESSAGES file.  
  17.  
  18.     USEMALL is executed as follows:
  19.  
  20.        USEMALL [param1] [param2] [param3]
  21.  
  22.          param 1 = node # (default is 1)
  23.          param 2 = FULL PATH/FILENAME for MESSAGES       
  24.                           (default is MESSAGES in same directory)
  25.          param 3 = TIME ALLOWED IN DOOR.  (default is 30 minutes
  26.                    a negative number overrides users' time left for day) 
  27.       
  28.         IMPORTANT: IF parameters 2 or 3 are used, then the preceding 
  29.                    parameters must be entered.
  30.  
  31.      The program (if successful) will create PCBOARD.SYS and PCBOARD.DAT
  32. iε thσ curren⌠ director∙ - the bat file mus⌠ theε cop∙ them t∩ where-eve≥
  33. needed.  A big problem with older PCBOARD D)oorware was that if a user entered
  34. almost any PCBoard D)oor using comms parameters E,7,1, then the D)oor would
  35. crash the system leaving it hung.  Although new PCBoard D)oorware does correct
  36. this oversight, we still have ensured that comms parameters E,7,1 will not
  37. work.  If USEMALL is executed with the comms parameters E,7,1, PCBOARD.SYS
  38. will not be generated, the user will be informed of the problem, and if our
  39. sample batch file is used, the system will recover back to RBBS.
  40.  
  41.          Here is our sample batch file to execute the DOOR 
  42.          Power Struggle.  RBBS files are in C:\RBBS16
  43.          and POWER is in C:\RBBS16\POWER
  44.  
  45.        IF EXIST PCBOARD.SYS DELETE PCBOARD.SYS
  46.        USEMALL %1 C:\RBBS16\TEXT\MESSAGES -10
  47.        IF EXIST PCBOARD.SYS GOTO OK
  48.        GOTO END
  49.        :OK
  50.        CD\RBBS16\POWER
  51.        COPY C:\RBBS16\PCBOARD.SYS
  52.        COPY C:\RBBS16\PCBOARD.DAT
  53.        POWER POWER-1.CFG
  54.        :END
  55.  
  56.  
  57.  FURTHER INFO ON Parameter 3
  58.          
  59.      If time allowed is specified as 0 (zero) then time allowed
  60.  will be equal to time remaining.
  61.  
  62.      If time allowed is specified as a NEGATIVE number, then time
  63. allowed will be set to time remaining or parameter #3, if
  64. greater [when converted to positive #].  Thus, you could
  65. allow someone into a door giving them [say] 10 minutes, even
  66. though they only had 3 minutes left when exiting from RBBS.  This
  67. was added specifically for SYSOPs that wanted a registration D)oor.
  68. In that way, any new user could look around a board, and still have
  69. enough time to complete the questionare even though they only had
  70. 1 minute remaining as the door loaded.
  71.  
  72.     This utility has been tested on a variety of PCBOARD D)oors, but
  73. the PCBOARD doors do not necessarily conform to any standard.  If
  74. you cannot get a specific door to work and the documentation with the door
  75. does not help, then try adding a file called USERS into the Doors 
  76. subdirectory.  This file can be anything as long as it's at least 256 bytes
  77. in length.  Power Struggle requires this file there, although it never
  78. uses the file other than to check on its existence.  The RECNOF$ in
  79. PCBOARD.SYS field declaration is the pointer for this file, and it has to 
  80. point to any record greater than one or all users are considered to be
  81. the SYSOP.
  82.     We have provided the BASIC source code with the exe file.  One of the
  83. reasons that most of the other RBBS-PCB utilities were not useful was
  84. because the source code was not included, so when the odd door required
  85. something extra, the utility was inflexible.  Plus providing the source 
  86. goes along with the RBBS philosophy of providing as much information to the
  87. collective users so that we can all work together.
  88.     If you still cannot get a door to run, then you can contact either of
  89. us at our respective BBSes and we will try and help:
  90.  
  91.        Phil Dewitt :  DGS BBS 703-590-1441
  92.        Steven Kling : Technopeasants' BBS  301-927-4258 
  93.  
  94.  
  95.